Saltar al contenido principal

Trabajo con Proveedores — Desarrollo Web

Lineamientos y consideraciones para el trabajo con proveedores en el área de Desarrollo Web.

Flujo ideal de desarrollo​

Acceso al repositorio​

  • El proveedor crea o debe tener una cuenta de GitLab.
  • Nosotros le damos acceso a un repositorio específico mediante invitación (el repositorio es privado).
  • El acceso es solo a ese repositorio.
  • Al terminar el proyecto se le revocan los accesos al repositorio, a menos que el proveedor siga ofreciendo soporte al proyecto.

Ramas y control de cambios​

  • El proveedor trabaja todos los cambios en la rama develop o en ramas subsecuentes.
  • Al pasar a producción, es el área interna, líder de área o desarrollador asignado quien revisa los cambios y los empuja a main.

Revisión de cambios​

  • La revisión es a alto nivel; no se requiere un flujo formal ni extenso.
  • Basta con un Merge Request de develop hacia main para revisar y aprobar.

Estándar de commits​

  • Formato: prefijo + : + descripción en inglés de los cambios de ese commit.
  • Prefijos válidos:
    • feat:
    • fix:
    • hot-fix:
    • style:
  • Ejemplo: fix: correct validation on login form

Llaves y credenciales​

  • Todas las llaves o claves privadas que vayan en un archivo .env deben enviarse a Inmersys:
    • Como mensaje, y
    • Por correo electrónico con los detalles y el archivo .env en sí.

Documentación del repositorio​

  • Tanto el repositorio de Frontend como el de Backend deben incluir un archivo README.md con toda la información detallada:
    • Arquitectura del proyecto.
    • Guía para correr el proyecto (instalación, dependencias, configuración).

Respaldo​

  • Git es el respaldo. No es necesario subir el código a otro lado.

Despliegue a producción​

  • Cuando se sube a producción, nosotros le pasamos los servicios donde se desplegará.
  • Si el cliente tiene un servicio específico, se le asesora sobre los flujos de despliegue.
  • Si Inmersys es el proveedor de hosting, el despliegue lo hace alguien interno del área, guiado y asesorado por la persona (proveedor) que realizó el proyecto, por si hay detalles menores.

Lineamientos de código​

  • Skeleton: si el proyecto inicia desde cero, se le pasa al proveedor un skeleton de Frontend y de Backend sobre el cual debe desarrollar.
  • No hay reglas estrictas de cómo escribir el código, cómo hacer funciones o qué arquitectura utilizar → es libre para el proveedor.
  • Todos los cambios se revisan.